home *** CD-ROM | disk | FTP | other *** search
/ SGI Freeware 1999 August / SGI Freeware 1999 August.iso / dist / fw_psutils.idb / usr / freeware / catman / u_man / cat1 / pstops.Z / pstops
Encoding:
Text File  |  1999-07-16  |  6.6 KB  |  199 lines
  1.  
  2.  
  3.  
  4.      PPPPSSSSTTTTOOOOPPPPSSSS((((1111))))UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV ((((PPPPSSSSUUUUttttiiiillllssss RRRReeeelllleeeeaaaasssseeee 1111 PPPPaaaattttcccchhhhlllleeeevvvveeeellll 11117777))))PPPPSSSSTTTTOOOOPPPPSSSS((((1111))))
  5.  
  6.  
  7.  
  8.      NNNNAAAAMMMMEEEE
  9.       pstops - shuffle pages in a PostScript file
  10.  
  11.      SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.       ppppssssttttooooppppssss [ ----qqqq ]    [ ----bbbb ] [ ----wwww_w_i_d_t_h ] [ ----hhhh_h_e_i_g_h_t ]    [ ----pppp_p_a_p_e_r ] [
  13.       ----dddd_l_w_i_d_t_h ] _p_a_g_e_s_p_e_c_s [ _i_n_f_i_l_e    [ _o_u_t_f_i_l_e ] ]
  14.  
  15.      DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  16.       _P_s_t_o_p_s rearranges pages from a PostScript document, creating
  17.       a new    PostScript file.  The input PostScript file should
  18.       follow the Adobe Document Structuring    Conventions.  _P_s_t_o_p_s
  19.       can be used to perform a large number    of arbitrary re-
  20.       arrangements of Documents, including arranging for printing
  21.       2-up,    4-up, booklets,    reversing, selecting front or back
  22.       sides    of documents, scaling, etc.
  23.  
  24.       _p_a_g_e_s_p_e_c_s follow the syntax:
  25.  
  26.            _p_a_g_e_s_p_e_c_s   = [_m_o_d_u_l_o:]_s_p_e_c_s
  27.  
  28.            _s_p_e_c_s       = _s_p_e_c[+_s_p_e_c_s][,_s_p_e_c_s]
  29.  
  30.            _s_p_e_c       = [-]_p_a_g_e_n_o[_L][_R][_U][@_s_c_a_l_e][(_x_o_f_f,_y_o_f_f)]
  31.  
  32.       _m_o_d_u_l_o is the    number of pages    in each    block. The value of
  33.       _m_o_d_u_l_o should    be greater than    0; the default value is    1.
  34.       _s_p_e_c_s    are the    page specifications for    the pages in each
  35.       block. The value of the _p_a_g_e_n_o in each _s_p_e_c should be
  36.       between 0 (for the first page    in the block) and _m_o_d_u_l_o-1
  37.       (for the last    page in    each block) inclusive.    The optional
  38.       dimensions _x_o_f_f and _y_o_f_f shift the page by the specified
  39.       amount.  _x_o_f_f    and _y_o_f_f are in    PostScript's points, but may
  40.       be followed by the units ccccmmmm or iiiinnnn to convert to centimetres
  41.       or inches, or    the flag wwww or hhhh    to specify as a    multiple of
  42.       the width or height.    The optional parameters    _L, _R, and _U
  43.       rotate the page left,    right, or upside-down.    The optional
  44.       _s_c_a_l_e    parameter scales the page by the fraction specified.
  45.       If the optional minus    sign is    specified, the page is
  46.       relative to the end of the document, instead of the start.
  47.  
  48.       If page _s_p_e_cs    are separated by ++++ the pages will be merged
  49.       into one page; if they are separated by ,,,, they will be on
  50.       separate pages.  If there is only one    page specification,
  51.       with _p_a_g_e_n_o zero, the    _p_a_g_e_n_o may be omitted.
  52.  
  53.       The shift, rotation, and scaling are performed in that order
  54.       regardless of    which order they appear    on the command line.
  55.  
  56.       The -_w option    gives the width    which is used by the wwww
  57.       dimension specifier, and the -_h option gives the height
  58.       which    is used    by the hhhh dimension specifier. These dimensions
  59.       are also used    (after scaling)    to set the clipping path for
  60.  
  61.  
  62.  
  63.      Page 1                          (printed 7/6/99)
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.      PPPPSSSSTTTTOOOOPPPPSSSS((((1111))))UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV ((((PPPPSSSSUUUUttttiiiillllssss RRRReeeelllleeeeaaaasssseeee 1111 PPPPaaaattttcccchhhhlllleeeevvvveeeellll 11117777))))PPPPSSSSTTTTOOOOPPPPSSSS((((1111))))
  71.  
  72.  
  73.  
  74.       each page.  The -_p option can    be used    as an alternative, to
  75.       set the paper    size to    aaaa3333,,,, aaaa4444,,,,    aaaa5555,,,, bbbb5555,,,,    lllleeeetttttttteeeerrrr,,,,    lllleeeeggggaaaallll,,,, or
  76.       11110000xxxx11114444.... The default paper size    is aaaa4444....
  77.  
  78.       The -_b option    prevents any bbbbiiiinnnndddd operators in the PostScript
  79.       prolog from binding. This may    be needed in cases where
  80.       complex multi-page re-arrangements are being done.
  81.  
  82.       The -_d option    draws a    line around the    border of each page,
  83.       of the specified width.  If the _l_w_i_d_t_h parameter is omitted,
  84.       a default linewidth of 1 point is assumed. The linewidth is
  85.       relative to the original page    dimensions, _i._e. it is scaled
  86.       up or    down with the rest of the page.
  87.  
  88.       Pstops normally prints the page numbers of the pages re-
  89.       arranged; the    -_q option suppresses this.
  90.  
  91.      EEEEXXXXAAAAMMMMPPPPLLLLEEEESSSS
  92.       This section contains    some sample re-arrangements. To    put
  93.       two pages on one sheet (of A4    paper),    the pagespec to    use
  94.       is:
  95.  
  96.               2:0L@.7(21cm,0)+1L@.7(21cm,14.85cm)
  97.  
  98.       To select all    of the odd pages in reverse order, use:
  99.  
  100.                       2:-0
  101.  
  102.       To re-arrange    pages for printing 2-up    booklets, use
  103.  
  104.               4:-3L@.7(21cm,0)+0L@.7(21cm,14.85cm)
  105.  
  106.       for the front    sides, and
  107.  
  108.               4:1L@.7(21cm,0)+-2L@.7(21cm,14.85cm)
  109.  
  110.       for the reverse sides    (or join them with a comma for duplex
  111.       printing).
  112.  
  113.      AAAAUUUUTTTTHHHHOOOORRRR
  114.       Copyright (C)    Angus J. C. Duggan 1991-1995
  115.  
  116.      SSSSEEEEEEEE AAAALLLLSSSSOOOO
  117.       psbook(1), psselect(1), pstops(1), epsffit(1), psnup(1),
  118.       psresize(1), psmerge(1), fixscribeps(1), getafm(1),
  119.       fixdlsrps(1),    fixfmps(1), fixmacps(1), fixpsditps(1),
  120.       fixpspps(1), fixtpps(1), fixwfwps(1),    fixwpps(1),
  121.       fixwwps(1), extractres(1), includeres(1)
  122.  
  123.      TTTTRRRRAAAADDDDEEEEMMMMAAAARRRRKKKKSSSS
  124.       PPPPoooossssttttSSSSccccrrrriiiipppptttt is    a trademark of Adobe Systems Incorporated.
  125.  
  126.  
  127.  
  128.  
  129.      Page 2                          (printed 7/6/99)
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136.      PPPPSSSSTTTTOOOOPPPPSSSS((((1111))))UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV ((((PPPPSSSSUUUUttttiiiillllssss RRRReeeelllleeeeaaaasssseeee 1111 PPPPaaaattttcccchhhhlllleeeevvvveeeellll 11117777))))PPPPSSSSTTTTOOOOPPPPSSSS((((1111))))
  137.  
  138.  
  139.  
  140.      BBBBUUUUGGGGSSSS
  141.       _P_s_t_o_p_s does not accept all DSC comments.
  142.  
  143.  
  144.  
  145.  
  146.  
  147.  
  148.  
  149.  
  150.  
  151.  
  152.  
  153.  
  154.  
  155.  
  156.  
  157.  
  158.  
  159.  
  160.  
  161.  
  162.  
  163.  
  164.  
  165.  
  166.  
  167.  
  168.  
  169.  
  170.  
  171.  
  172.  
  173.  
  174.  
  175.  
  176.  
  177.  
  178.  
  179.  
  180.  
  181.  
  182.  
  183.  
  184.  
  185.  
  186.  
  187.  
  188.  
  189.  
  190.  
  191.  
  192.  
  193.  
  194.  
  195.      Page 3                          (printed 7/6/99)
  196.  
  197.  
  198.  
  199.